Atari Mega Archive 1/Atari Mega Archive - Volume 1.iso/telecomm/flashupd.arc/UPDATE.DOC

Text File | 1985-11-20 | 12KB | 265 lines

                  Instructions for Flash 1.51 update file.

There are three files in this archive: UPDATE.DOC, UPDATE.PRG, and
UPDATE.DAT.  You are reading UPDATE.DOC.  UPDATE.PRG and UPDATE.DAT are used
to convert FLASH version 1.51 to version 1.52.  UPDATE will only work with
version 1.51, if you have an earlier version, you can get an update by
sending your original disk to Antic, Attn: FLASH Update, along with $5 for
shipping and handling.

Further on we'll describe the changes in Flash 1.52.  Meanwhile, here's how
to do the upgrade:

Place UPDATE.PRG, UPDATE.DAT, and _a back-up copy_ of FLASH.PRG version 1.51
on the same disk (or in the same folder of a hard disk).  (FLASH.PRG version
1.51 will be exactly 128,268 bytes long.)  Double-click to run UPDATE.PRG;
the update procedure will take a few moments to complete.  When your update
is completed, you should now have an additional file called FLASH152.PRG
that should be 131,924 bytes long.  If you wish, you may rename this to
FLASH.PRG.  Transfer FLASH152.PRG to whichever disk contains your FLASH.RSC
and other working files.  You're all set!

NOTE:  Hang on to your original FLASH 1.51 program in case we upgrade
UPDATE.PRG.

    Flash 1.52 adds some new features to Flash 1.51, including an ARC
command for calling the arc.ttp program directly, the new B-PLUS file
transfer protocol for CompuServe, extra commands for remote operation, and
much faster DO file operation. A few minor bugs are also fixed. The update
program will convert your copy of Flash version 1.51 completely to version
1.52. You use the original Flash 1.51 resource file with the updated
program.

                            FLASH 1.52 Features

      Flash 1.52 is a minor upgrade from the original Flash 1.51. The main
improvements are faster DO files, B-PLUS protocol, extra commands for remote
operation and an ARC command. There are also a number of bug fixes.

 DO file improvements

        I realized suddenly that with a few tricks I could make DO files run
two to three times faster by speeding up the display of commands on the
command line. A feature of this is that during the process of displaying
each command from a DO file on the command line, no input from the serial
port is processed. This is useful so the DO file won't miss any characters
on a WAIT command.

        There is a slight change to the Flash ALERT command. You can now put
an optional  numeric parameter after the variable to indicate the default
exit button that will exit the alert when you press 'return'. e.g.

 >alert "[1][This is an alert][OK|2nd|3rd]" $A 1|

0 is no default exit button, 1,2, or 3 sets the default exit button to the
first, second, or third button.

        Some people want to be able to compare two string variables with the
IFI command, but it failed because in something like:

>IFI $A $B TYPE "SUCCESS"|

$A was being compared to the two letter string '$B' and not the contents of
the variable $B . This was not really a bug, but laziness on my part. This
is now fixed.

        I can't believe I forgot to include a method of getting remote input
into a string variable in Flash 1.51. I have added one new command to fill
this gap:

>GET $X n|

will get a line of input from the serial port into variable $X (or whatever
variable you specify) with a timeout 'n' in seconds, where n is a number
from 1 to 9999. If no timeout is given, the default is two minutes.  Several
people have requested this type of command as they want to try writing their
own remote control DO file.

        To enhance the ability to do remote control access through DO files,
I have adjusted the DDIR [path] [file for output] command so that if you
specify a filename of AUX: for output, the directory will be transmitted out
the serial port, e.g.,

>SEND "Pathname:"|
>GET $A|
>DDIR $A AUX:|

would prompt a remote user for a pathname and then send the directory the
user asked for out the serial port, formatted for 80 columns. Any key (from
remote) pauses, when paused, any key continues.

NOTE: For proper use, I assume that ECHO and LF are ON for the GET command
so that the remote user gets to see what he/she types in properly. If you
want to design a remote user interface using a Flash DO file, use the
commands:

>LF ON|

and

>ECHO ON|

as soon as you get a connection. A recommended method would be:

>WAIT CONNECT|

then test carrier detect with:

>IF CD

If you get a carrier, then turn LF and ECHO on. Warning: if you turn echo on
before the modem has connected, then Flash will echo all modem responses and
you will get nonstop characters.

        Another tiny change I made to enhance remote operation was in the
SEND command. Normally, a '|' in the SEND command gets translated into a
carriage return. In the case that the LF setting is ON, the '|' characters
now gets translated into carriage return + line feed. This would be
convenient if you wanted to send a remote user a menu. Otherwise, with 1.51
you would have to imbed actual carriage return and line feed characters in
the SEND string or waste a string variable by making it equal to carriage
return + line feed. Both these options would be rather annoying.

B-PLUS protocol added

      Flash now has a fairly complete implementation of the B-Plus file
transfer protocol. The improvements over standard B-Protocol and Quick-B are
(1) the use of a CRC checksum for improved error detection and (2) block
send-ahead for faster uploads. B-Plus is indicated during file tranfers by
'B-P+' instead of 'B-P' on the command/status line.

      As far as I know, Flash is the first ST telecom program to include
B-Plus. I have not implemented some features of B-Plus, namely 1K blocks and
extended character quoting. The disadvantages of 1-K blocks on noisy phone
lines appear to outweigh the minor improvement in transfer speed that might
result.

'GEM' command sets path

        When using the GEM command to execute a GEM program, Flash will
automatically switch to the drive and path that the program is located in so
that it can find its resource file properly. When it returns, the path is
set back to the default path.

        I am so used to typing 'cd' for setting default path, instead of the
Flash 'dp' command, that I tend to do it unconsciously. I have adjusted
Flash so  that it recognizes 'cd' the same as 'dp' for those of you who are
used to command shell programs with this syntax..

New 'ARC' command

         I have added 'ARC' as a command in Flash. All you need to do is put
a copy of ARC.TTP in the SAME DRIVE AND FOLDER that you run Flash from.
Flash remembers the drive and folder that it is run from and then will
always use this path to call arc, even if you have changed default paths in
the meantime. Example: if you want to find the contents of the archive
'update.arc', type ARC V UPDATE on the Flash command line.

Other changes

        VT100 fix. Most IBM protocol VT100 convertors seem to draw text on
the screen with cursor positioning commands and hardly ever use carriage
returns and line feeds. This makes a real mess out of the capture buffer,
usually leaving everything on one or two lines. I have added code that will
hopefully add the necessary carriage returns/line feeds as well as
additional spaces if there is a cursor position command in the same row but
different column. This has not been tested very much, but I did not want to
delay releasing Flash 1.52 since only a handful of people requested this
feature. If I have to make further changes to this code, I will release a
revised update patch file. Be sure to save your original Flash 1.51 program
just in case.

Further additions

        In the capture buffer editor, Clr/Home key moves to the beginning of
the buffer, shift-Clr/Home moves to the end of the buffer.

        When you select loading the buffer (from the menu bar) and there is
already text in the buffer, you get an alert box warning you about this, in
case you meant to select MERGE instead.

        Control characters now pas